home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1999 March / EnigmA AMIGA RUN 35 (1999)(G.R. Edizioni)(IT)[!][issue 1999-03].iso / cd-sup / updatecopy / docs / updatecopy.doc next >
Text File  |  1999-01-01  |  7KB  |  173 lines
  1.  
  2.                         Documentation to UpDateCopy
  3.  
  4.                           Version 0.52 - 21.02.1997
  5.                    $VER: UpDateCopy.doc 0.52 (21.02.1997)
  6.  
  7.  
  8.                          Written by Sven Steiniger
  9.                                -- Cardware --
  10.  
  11.  
  12. ------------------------------------------------------------------------------
  13.                                 Introduction
  14. ------------------------------------------------------------------------------
  15.  
  16.     UpDateCopy is an extension of the standard copy command. It does not
  17.     only copy files and create (if necessary) directories but also process
  18.     already existing files: older files are replaced automatical by newer
  19.     ones. UpDateCopy first try to find a version-string within the files
  20.     ($VER: Programname Version.Reversion) and copy only the one with the
  21.     higher version or simply compares the dates.
  22.     UpDateCopy features multiple sourcefiles, pattern matching and
  23.     recursively directory scanning.
  24.  
  25.  
  26. ------------------------------------------------------------------------------
  27.                             System requirements
  28. ------------------------------------------------------------------------------
  29.  
  30.     - an Amiga :-)
  31.     - at least KickStart 2.04
  32.  
  33. ------------------------------------------------------------------------------
  34.                                    Usage
  35. ------------------------------------------------------------------------------
  36.  
  37.  
  38.     Format:
  39.         UpDateCopy [FROM] {<sourcename|sourcepattern>} [TO] <destname>
  40.                        [QUIET] [ALL] [FORCE] [DEEP] [NODATECHECK]
  41.                            [TESTMODE] [CLONE] [PAPF] [SMARTINFO] [FAST]
  42.  
  43.     Template:
  44.         UpDateCopy FROM/M,TO/A,QUIET/S,ALL/S,FORCE/S,DEEP/S,
  45.                            NDC=NODATECHECK/S,TESTMODE/S,CLONE/S,PAPF/S,
  46.                            SMARTINFO/S,FAST/S
  47.  
  48.  
  49.     Parameter:
  50.         sourcename, sourcepattern
  51.             The names of the files to be copied or directories
  52.             (also name patterns).
  53.         destname
  54.             Name of destination directory.
  55.         QUIET
  56.             Switch output off. Only error messages are displayed.
  57.         ALL
  58.             If specified than also subdirctories are scaned and
  59.             copied otherwise only files and directorynames of the
  60.             source directory.
  61.         FORCE
  62.             Normally delete-protected files could not be over-
  63.             written. If you specify this option UpDateCopy
  64.             ignores all Protectionbits.
  65.         DEEP
  66.             UpDateCopy only compares the dates of existing files.
  67.             With the DEEP-option UpDateCopy scans the files first
  68.             for version-strings ($VER:) and only if this fails
  69.             the dates are compared.
  70.             Note: Although this search is written in fast
  71.                   assembly language it slows things down.
  72.         NODATECHECK
  73.             UpDateCopy do not compare the datestamps. This might
  74.             be useful for packed files.
  75.             Note: If this option is specified then the
  76.                   DEEP-scanmode is switch on by default.
  77.         TESTMODE
  78.             Switchs the testmode on. UpDateCopy don't copy/replace
  79.             older files and directories are not created. But the
  80.             outputs are the same as without the testmode.
  81.             This option can be used for simply comparing the
  82.             contents of two directories.
  83.         CLONE
  84.             If you set this option, UpDateCopy copies the
  85.             datestamp from the source file.
  86.         PAPF
  87.             Normally UpDateCopy clears the archive protection flag
  88.             of a copied file. If you set this option this flag is
  89.             not altered.
  90.             Note: UpDateCopy always copies
  91.                 - the protection flags (except archive)
  92.                 - and the file comment.
  93.         SMARTINFO
  94.             Now UpDateCopy don't displays skipped directories and
  95.             files.
  96.         FAST
  97.             Switches off linefeeds. This increases processing
  98.             speed if you copy many small files (scrolling the
  99.             display takes longer than scanning the file).
  100.  
  101.     Examples:
  102.         UpDateCopy #? ram:T
  103.             Copies all files of the current directory to
  104.             "ram:T". Not existing files are copied. Not existing
  105.             directories are created. Existing files are only
  106.             overwritten if they have a older date.
  107.         UpDateCopy #? ram:T ALL
  108.             Same as previous but now also scans through sub-
  109.             directories.
  110.         UpDateCopy #? ram:T DEEP
  111.             Same as first example but do not only compares the
  112.             dates but first compare the version-strings (if
  113.             possible)
  114.         UpDateCopy #? ram:T DEEP NDC
  115.             Same as first example but do only compares the
  116.             version-strings. If no version-string is found nothing
  117.             is copied/replaced even if the datestamp is newer.
  118.             Also not existing directories are not created.
  119.         UpDateCopy #?.info #?.e TO=ram:T ALL DEEP esource:3D/Plotter3D
  120.             Copies all files of the of the current directory to
  121.             "ram:T" which ends with ".info" or ".e". Also sub-
  122.             directories are scanned and the file
  123.             "esource:3D/Plotter3D" is copied.
  124.  
  125. ------------------------------------------------------------------------------
  126.                                    Author
  127. ------------------------------------------------------------------------------
  128.  
  129.     Send Bugreports, Ideas or anything else to:
  130.  
  131.                                Sven Steiniger
  132.  
  133.                               Rathener Str. 29
  134.                                01259 Dresden
  135.                                 Deutschland
  136.  
  137.                      Email: ss37@irz.inf.tu-dresden.de
  138.  
  139. ------------------------------------------------------------------------------
  140.                                 Legal Stuff
  141. ------------------------------------------------------------------------------
  142.  
  143. UpDateCopy is CARDWARE, means that you should send me an email if you use it.
  144. Also small presents are very welcome.
  145.  
  146.  Copyright
  147. -----------
  148. UpDateCopy is written by Sven Steiniger. You may use the source freely in your
  149. programs or you may extend it to your own UpDateCopy. But please do not spread
  150. a modified version under this name (UpDateCopy). If the source was useful to
  151. you it would be a good idea to send me your program.
  152.  
  153.  Distribution
  154. --------------
  155. This program can be freely distributed as long as the archiv-contents is
  156. not changed and no profits are made.
  157. Archiv contents:
  158.     UpDateCopy/UpDateCopy        - the executable
  159.     UpDateCopy/Source/UpDateCopy.e    - the source file (E language)
  160.     UpDateCopy/Docs/UpDateCopy.doc    - english documentation
  161.     UpDateCopy/Docs/UpDateCopy.dok  - german documentation
  162.     UpDateCopy/Scripts/BackUpUp     - Backup-script by Attilio Scifoni
  163.     UpDateCopy/Scripts/BackUpUp2    - modified BackUpUp-script
  164.     UpDateCopy/Scripts/BackUpUp_GUI - BackUpUp2 with requesters
  165.     UpDateCopy/Scripts/BackUpUp.doc - english description of these scripts
  166.     UpDateCopy/readme        - short information
  167.  
  168.  
  169.  Disclaimer
  170. ------------
  171. I am (The author) are in no way liable for damages or loss of data directly or
  172. indirectly caused by this program.
  173.